T
Entity type
IdeaBlade DevForce 2010 Help Reference
CreateEntity<T>(String) Method
See Also  Example Send Feedback
IdeaBlade.EntityModel Assembly > IdeaBlade.EntityModel Namespace > EntityManager Class > CreateEntity Method : CreateEntity<T>(String) Method



entitySetName
Name of the entity set for the new entity
Create a new entity of the requested type.

Syntax

Visual Basic (Declaration) 
Public Overloads Function CreateEntity(Of T As Class)( _
   ByVal entitySetName As String _
) As T
Visual Basic (Usage)Copy Code
Dim instance As EntityManager
Dim entitySetName As String
Dim value As T
 
value = instance.CreateEntity(Of T)(entitySetName)
C# 
public T CreateEntity<T>( 
   string entitySetName
)
where T: class
C++/CLI 
public:
T^ CreateEntitygeneric<typename T>
( 
   String^ entitySetName
) 
where T: ref class

Parameters

entitySetName
Name of the entity set for the new entity

Type Parameters

T
Entity type

Return Value

A new instance of the specified entity type

Example

C#Copy Code
DomainModelEntityManager mgr = new DomainModelEntityManager();

// Retrieve an order
Order order = mgr.Orders.FirstOrNullEntity(o=> o.OrderID == 1);
// Retrieve a product
Product product = mgr.Products.FirstOrNullEntity(p => p.ProductID == 1);

// Create an OrderDetail 
OrderDetail dtl = mgr.CreateEntity<OrderDetail>();
// assign key fields
dtl.OrderSummary = order;
dtl.Product = product;

// add the OrderDetail to the EntityManager cache
DebugFns.WriteLine("entity state before add = " + dtl.EntityState);
dtl.AddToManager();
DebugFns.WriteLine("entity state after add = " + dtl.EntityState);

Remarks

You may either "new" a business object (unless it's Abstract (or MustInherit in Visual Basic), or use one of the overloaded CreateEntity methods. Any new entity has a "detached" EntityAspect.EntityState until added to the EntityManager cache using either IdeaBlade.EntityModel.EntityManager.AddEntity or the object's IdeaBlade.EntityModel.EntityAspect.AddToManager method.

The "entity set" is a construct within the Entity Framework which allows you to logically group entities of the same type. See EntityQuery.EntitySetName for more information. If an entity set name is not provided then the EntityGroup.DefaultEntitySetName is used.

Requirements

Target Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows Server 2008 family

See Also

© 2013 All Rights Reserved.